Claude Code 解读 02：核心命令指南

cd your-project
claude

give me an overview of this codebase
explain the main architecture patterns used here
what are the key data models?
how is authentication handled?

我需要详细了解订单模块的代码结构

use the Explore agent to find all files related to payment processing

我需要重构认证系统以支持 OAuth2，请制定详细的迁移计划

claude
/init

# 项目说明

## 技术栈
- 后端：Node.js + Express
- 数据库：PostgreSQL

## 构建命令
- 开发：`npm run dev`
- 测试：`npm test`
- 构建：`npm run build`

## 编码规范
- 使用 2 空格缩进
- 异步操作统一使用 async/await
- 所有 API 路由在 `src/api/` 下

## 注意事项
- 生产环境禁止直接操作数据库
- 敏感配置使用环境变量

/mcp

从 Google Drive 读取最新的技术设计文档
查询 Jira 上 OPEN 状态的所有任务
把这段代码审查意见发到 Slack 频道

/claude-api
show me how to use the Claude API for streaming responses in Python

create a new file src/utils/format.ts with utility functions for date formatting
update the user.ts file to add a null check before accessing the profile field
run npm test to verify the changes

/diff

{
  "hooks": [
    {
      "matcher": { "type": "PostToolUse", "tool": "Edit" },
      "command": { "type": "command", "command": "npx prettier --write {filePath}" }
    }
  ]
}

run the new tests and fix any failures
add test cases for edge conditions in the notification service

run `npm run build` and check for any errors
帮我运行 gcc 编译，如果有链接错误告诉我

/debug the session started 10 minutes ago when I tried to build

commit my changes with a descriptive message
create a new branch called feature/oauth2-auth
create a pull request for the OAuth2 refactor
include the plan summary in the PR description

/branch exploring-alternative-auth-approach

我需要...
│
├─► 分析代码但不改它
│     └─► Plan Mode：`/permission-mode plan` 或 `Shift+Tab`
│
├─► 搜索代码库找东西
│     └─► 直接问，或 `Explore` 子代理（只读，不污染上下文）
│
├─► 对代码库做修改
│     ├─► 小改动：直接自然语言描述目标
│     └─► 大改动：Plan Mode 制定计划 → 确认后执行
│
├─► 运行命令（编译/测试/部署）
│     └─► Bash 工具：`run npm test`
│
├─► 把重复性工作自动化
│     ├─► 每次编辑后自动格式化 → Hooks
│     ├─► 某个模式反复出现 → 自定义 Skill
│     └─► 大规模批量改造 → /batch
│
├─► 接入外部工具（Google Drive / Jira / Slack）
│     └─► MCP：`/mcp` 添加服务器
│
├─► 排查 AI 行为异常
│     └─► `/debug`
│
├─► 释放上下文空间（对话太长）
│     └─► `/compact`
│
├─► 创建一个长期监控循环
│     └─► `/loop 5m check if the deploy finished`
│
└─► 导出/保存对话内容
      └─► `/export` 或 `/copy [N]`

cd ~/projects/myapp
claude

give me an overview of this codebase
what's the current project structure?
how is the payment module organized?
trace the payment flow from order creation to successful charge

/init

claude --permission-mode plan

I need to migrate our Stripe integration from v2 to v3 and add subscription support.
Please create a detailed migration plan covering:
1. What changed between v2 and v3 in Stripe API
2. Required database schema changes
3. Backward compatibility approach
4. Testing strategy
5. Rollback plan

create a new branch called feature/stripe-v3-migration

update all Stripe SDK imports from stripe-v2 to stripe-v3
add subscription management to the payment service
update the webhook handler to support both v2 and v3 event formats during migration

/diff

commit "migrate: update Stripe SDK from v2 to v3"

run the full test suite and fix any failures
add integration tests for the new subscription flow
run Stripe test mode to verify the full payment flow

create a pull request for the Stripe v3 migration
include the full migration plan in the PR description

/loop 1h "check if the PR has review comments, if so summarize them and notify me"

/batch migrate src/ from JavaScript to TypeScript

❌ 低效："用 Edit 工具打开 src/payment.ts，在第 45 行之后插入这段代码"
✅ 高效："在支付服务里加上幂等性检查"

# 在主会话里探索 → 上下文膨胀
"我在这个文件里探索一下..."

# 交给 Explore 子代理 → 上下文干净
"用 Explore agent 帮我找所有和缓存相关的代码"